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TRANSITION (SOURCE => DEST) 
ISA & CC PROPERTY VALUES 


HANDLER ACTION 


00 => 00 


NO TRANSITION EXCEPTION 


00 => 01 


VECT_m_X86_CC EXCEPTION - HANDLER CONVERTS FROM NATIVE TO x86 CONVENTIONS 


00 =>1x 


VECT xxx X86 CC EXCEPTION -HANDLER CONVERTS FROM NATIVE x86 CONVENTIONS, 

SETS UP EXPECTED EMULATOR AND PROFILING STATE 


01 => 00 


VECT_xxx_TAP_CC EXCEPTION • HANDLER CONVERTS FROM x86 TO NATIVE CONVENTIONS 


01 => 01 


NO TRANSITION EXCEPTION 


01 => 1x 


VECT X86 ISA EXCEPTION [CONDITIONAL BASED ON PCW.X86 ISA ENABLE FLAG] 
• SETS UP EXPECTED EMULATOR AND" PROFILING STATE 


1x=> 00 


VECT_m_TAP_CC EXCEPTION - HANDLER CONVERTS FROM x86 TO NATIVE CONVENTIONS 


1x=> 01 


VECT TAP ISA EXCEPTION [CONDITIONAL BASED PCW.TAP ISA ENABLE FLAG] 
- NO CONVENTION CONVERSION NECESSARY 
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NAME 


DESCRIPTION 


TYPE 


VECT call X86 CC 


PUSH ARGS, RETURN ADDRESS, SET UP x86 STATE 


FAULT ON TARGET INSTRUCTION 


VECTjump X86 CC 


SETUPx86 STATE 


FAULTON TARGET INSTRUCTION 


VECT ret no fp X86 CC 


RETURN VALUE TO EAX:EDX, SET UP x86 STATE 


FAULT ON TARGET INSTRUCTION 


VECT ret fp X86 CC 


RETURN VALUE TO x86 FP STACK, SET UP x86 STATE 


FAULT ON TARGET INSTRUCTION 


VECT call TAP CC 


x86 STACK ARGS, RETURN ADDRESS TO REGISTERS 


FAULTON TARGET INSTRUCTION 


VECTjump TAP CC 


x86 STACKARGS TO REGISTERS 


FAULTON TARGET INSTRUCTION 


VECT ret no fp TAP CC 


RETURN VALUE TO RVO 


FAULT ON TARGET INSTRUCTION 


VECT ret any TAP CC 


RETURN TYPE UNKNOWN, SETUP RVO AND RVDP 


FAULTONTARGET INSTRUCTION 
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360 

ELSE IF DIRECTED TO X86 
SAVE TAPESTRY CONTEXT! 
IN ALLOCATED SAVE 
SLOT (8 
EIP<1:0> —"10" 



CASE "10" OR "11" RETURN: 
MOVE FUNCTION RETURN 
VALUE FROM X86 HOME 
TO TAPESTRY HOME 

CASE RESUME FROM EXCEPTION 
RESTORE TAPESTRY 
CONTEXT FROM 
SAVE SLOT 
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FLAT 32-BIT "NEAR" ADDRESS SPACE 



r-x86? RISC?— i 
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x86 STACK-BASED CONVENTIONS 
. RISC USES HIGHER PERFORMANCE 

REGISTER-BASED CONVENTIONS 
.CALLER HAS NO KNOWLEDGE 

OF CALLEE'S ISA 
.CALLEE HAS NO KNOWLEDGE 

OF ISA TO WHICH IT WILL RETURN 
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FLAT 32-BIT "NEAR" ADDRESS SPACE 




X86-RISC TRANSITION: 
MAP x86 CALL TO RISC 

322 (FIG. 3H) 



RISC-X86 TRANSITION: 
MAPx86 RETURN TO RISC 

342 (FIG. 31) 



NO ISA TRANSITION: 
NO MAPPING REQUIRED 
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FLAT 32-BIT "NEAR" ADDRESS SPACE 




RISC-X86 TRANSITION: 
MAP RISC CALL TO x86 

340 (FIG. 31) 



X86-RISC TRANSITION: 
MAP RISC RETURN TO x86 

329,332 (FIG. 3H) 



NO ISA TRANSITION: 
NO MAPPING REQUIRED 



FIG. 3D 



FLAT 32-BIT "NEAR" ADDRESS SPACE 




X86-RISC TRANSITION: 
MAP RISC RETURN TO x86 

329,332 (FIG.3H) 



RISC-X86 TRANSITION: 
MAP RISC CALL TO x86 

343-348 (FIG. 31) 



NO ISA TRANSITION: 
NO MAPPING REQUIRED 
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RISC-X86 TRANSITION: 
MAP x86 RETURN TO RISC 

342 (FIG. 31) 



X86-RISC TRANSITION: 
MAPx86 CALL TO RISC 

322 (FIG.3H) 



NO ISA TRANSITION: 
NO MAPPING REQUIRED 
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x86 PREAMBLE: 

(NEED NOT BE INLINE) 

■LOAD REGISTER ARGS 

FILL-IN RXA (RETURN TRANSFER ARGUMENT AREA) 



319 



r GENERAL ENTRY: 



YES 



317 



XD == 0? 



i— NATIVE.ENTRY: - 

NATIVE PREAMBLE: 
(TYPICALLY VACUOUS) 



-VARARGS 



NO 



318 



-AP FORAVERY BIG ARGUMENT LIST 



OMIT IF 
NATIVE ONLY 



FUNCTION BODY: 



SETUPXD: 

XD ^<DESCRIPTOR_CONSTANT> 

RET 
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X86-to Tapestry transition exception handler 

// This handler is entered under the following conditions: 
// 1. An x86 caller invokes a native function 
// 2. An x86 function returns to a native caller 

// 3. x86 software returns to or resumes an interrupted native function following 
// an external asynchronous interrupt, a processor exception, or a context switch 
r 321 

dispatch on the two least-significant bits of the destination address { 
case"00" // calling a native subprogram 

// copy linkage and stack frame information and call parameters from the memory 
// stack to the analogous Tapestry registers 



320 

/ 



LR — [SP++] 
AP— SP 
SP— SP-8 
SP— SP & (-32) 
XD— 0 



-323 
^324 



case "01" 



//set up linkage register-^" 

// address of first argument ■ 325 

// allocate return transfer argument area s~ 
II round the stack pointer down to a 0 mod 32 boundary 
// inform callee that caller uses X86 calling conventions ■ 



^322 



-327 



328 



// resuming an X86 thread suspended during execution of a native routine 



if the redundant copies of the save slot number in EAX and EDX do not match or if 
the redundant copies of the timestamp in EBX:ECX and ESI:EDI do not match { 
// some form of bug or thread corruption has been detected 
goto TAPESTRY_CRASH_SYSTEM( thread-corruption-error-code ) 372 



} 



371 



} 



save the EBX:ECX timestamp in a 64-bit exception handler temporary register"! 

(this will not be overwritten during restoration of the full native context) J 
use save slot number in EAX to locate actual save slot storage— -^374 
restore full entire native context (includes new values for all x86 registers) - 
if save slot's timestamp does not match the saved timestamp { ^--376 
// save slot has been reallocated; save slot exhaustion has been detected 
goto TAPESTRY_CRASH_SYSTEM( save-slot-overwritten-error-code ) 



373 



375 



>370 



} 



-378 



377 



free the save slot - 

case"10" // returning from X86 callee to native caller, result already in registers 

RV0<63:32> — edx<31 :00> // in case result is 64 bits 333 

convert the FP top-of-stack value from 80 bit X86 form to 64-bit form in RVDP "^^004 
SP —ESI // restore SP from time of call — — 337 0M 

case"ir // returning from X86 callee to native caller, load large result from memory : 

RV0..RV3 — load 32 bytes from [ESI-32] // (guaranteed naturally aligned) 
SP — ESI // restore SP from time of call 



} 

EPC 
RFE 




>332 



^329 



— EPC&-4 
"^338 



// reset the two low-order bits to zero 



336 
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340 



Tapestry-to-X86 transition exception handler 

// This handler is entered under the following conditions: 
// 1 . a native caller invokes an x86 function 
// 2. a native function returns to an x86 caller 
switch on XD<3:0> { 



XD 



XD 



XD 



-341 

RET_FP: // result type is floating point 

"FO/FI — FINFLATE.de( RVDP) // X86 FP results are 80 bits 
SP— from RXA save // discard RXA, pad, args 

FPCW— image after FINIT & push // FP stack has 1 entry 
goto EXIT 

RET.WRITEBACK: // store result to @RVA, leave RVA in eax 

RVA— from RXA save // address of result area 

copy decode(XD<8:4>) bytes from RV0..RV3 to [RVA] 

eax— RVA // X86 expects RVA in eax 

SP— from RXA save // discard RXA, pad, args 

FPCW— image after FINIT // FP stack is empty 

goto EXIT 

RET_SCALAR: // result in eax:eda 

edx<31 :00> — eax<63:32> // in case result is 64 bits 
SP— from RXA save // discard RXA, pad, args 

FPCW— image after FINIT // FP stack is empty 

goto EXIT 



>342 



XD 



CALL_HIDDEN_TEMP: 
esi— SP 
SP— SP-32 
RVA— SP 
LR<1:0>— "11 n 
goto CALL_COMMON 



// allocate 32 byte aligned hidden temp^, 
// stack cut back on return — ^ 
// allocate max size temp 1 
//RVA consumed later by RR J 
// flag address for return & reload 



344 



-345 



default: // remaining XD_CALL_xxx encodings 

esi— SP // stack cut back on return -v 

LR<1 :0> —"1 0" // flag address for return ^ 343 

CALLCOMMON: 347 346 

interpret XD to push and/or reposition args S 
[-SP] — LR // push LR as return address * 

EXIT: I- 348 

setup emulator context and profiling ring buffer pointer 



} 

RFE- 



-349 



//to original target 
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350 

interrupt/exception handler of Tapestry operating system: ^ 
II Control vectors here when a synchronous exception or asynchronous interrupt is to be 
// exported to / manifested in an x86 machine. 

//The interrupt is directed to something within the virtual X86, and thus there is a possibility 
// that the X86 operating system will context switch. So we need to distinguish two cases: 
// either the running process has only X86 state that is relevant to save, or 
// there is extended state that must be saved and associated with the current machine context 
// (e.g., extended state in a Tapestry library call in behalf of a process managed by X86 OS) 
if execution was interrupted in the converter - EPC.ISA == X86 { "1 

// no dependence on extended/native state possible, hence no need to save any f 351 
goto EM86_Deliver_lnterrupt( interrupt-byte ) J 
} else if EPC.TaxLActive { 

Ilk Taxi translated version of some X86 code was running. Taxi will rollback to an * 
//x86 instruction boundary. Then, if the rollback was induced by an asynchronous external 
// interrupt, Taxi will deliver the appropriate x86 interrupt. Else, the rollback was induced v ^ 
II by a synchronous event so Taxi will resume execution in the converter, ^triggering the ( 
II exception but this time with EPC.ISA == X86 
goto TAXi_Rollback( asynchronous-flag, interrupt-byte ) 
}else if EPC.EM86{ 

// The emulator has been interrupted. The emulator is coded to allow for such 
// conditions and permits re-entry during long running routines (e.g. far call through a gate) I 354 
// to deliver external interrupts 
goto EM86_Deliver_lnterrupt( interrupt-byte ) 



} else { 



363 



// This is the most difficult case - the machine was executing native Tapestry code on ^ 
// behalf of an X86 thread. The X86 operating system may context switch. We must save 
// all native state and be able to locate it again when the x86 thread is resumed. 
r 361 

allocate a free save slot; if unavailable free the save slot with oldest timestamp and try again 
save the entire native state (both the X86 and the extended state) 1 ~ R0 

save the X86 EIP in the save slot J 
overwrite the two low-order bits of EPC with "01" (will become X86 interrupt EIP) ^ 
store the 64-bit timestamp in the save slot, in the X86 EBX:ECX register pair (and, 1 „ fi . 

for further security, store a redundant copy in the X86 ESI:EDI register pair) f 6M 
store the a number of the allocated save slot in the X86 EAX register (and, again for *i 

further security, store a redundant copy in the X86 EDX register) j 365 

goto E M 86_D e I i ve r_ I nte rru pt ( interrupt-byte ) 

^369 
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>360 



typedef struct { 
save_slot_t * 
save_slot_t * 
unsigned int64 
unsigned int64 
unsigned int64 

timestampj 
int 

boolean 
} save_slot_t; 



newer, // pointer to next-most-recently-allocated save sloH 

older; // pointer to next-older save slot f 379c 

epc; // saved exception PC/IP 

pew; // saved exception PCW (program control word) 

registers[63]; // save the 63 writeable general registers 

// other words of Tapestry context 

timestamp; // timestamp to detect buffer overrun -n 

- - — - \_« 



►356 



save_slot_ID; // ID number of the save slot 
save_slot_is_full; // full / empty flag 



^-357 
359 



•358 



save_slot_t * 
save slot t * 



save_slot_head; 
save_slot_tail; 



// pointer to the head of the queue -\ 
// pointer to the tail of the queue 
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system initialization 

reserve several pages of unpaged memory for save slots 



FIG. 3K 



FLAT 32-BIT "NEAR" ADDRESS SPACE 

380 

i RISC — — i 





V 



PREPARE X86EXCEP. OR INT. 

ALLOC FREE OR OLDEST SAVE SLOT 
STORE TIMESTAMP & FULL STATE 
x86 REGS —SAVE SLOT ID, 

TIMESTAMP 
EPC<1:0>— 01 



-306,316,302 
MSV^U dJ 
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HANDLER: RISC TOx86 



XD CONTAINS RETURN-DESCRIPTOR: 
INTERPRET XD: 342 
- REFORMAT / REPOSTION RESULT 
-LOADFPCW 

SP — [SP] // POP RA AND ARGS [V 



XD CONTAINS CALL-DESCRIPTOR: 
ESI— SP 

INTERPRET XD, REPOSITION ARGS 
LR<1:0> — IxPERXD 
PUSH LRASRA(RETADDR) 




r 320 
HANDLER: x86 TO RISC 



EPC<1:0> == 00: 
LR — [SP] 
SP — SP + 4 
AP — SP 
SP — SP-8 
SP — SP & (-32) 
XD — 0 



322 



//RET AREA 



II 

II 
I I 
I I 
I I 
I I 
I I 
I I 
I I 



370 

EPC<1:0> ==01: 
x86 REGS POINTS TO SAVE SLOT 
USING TS VERIFY NO OVERWRITE 
RESTORE FULL STATE 
FREE SAVE SLOT 
EPC<1:0> — 00 



Or 



EPC<1:0> ==1x: 



329 332 



REFORMAT /REPOSTION THE 

FUNCTION RESULT PER EPC<0> 
SP— ESI 
EPC<1:0> — 00 



ST 
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RISC 
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317, 
r319 
PREAMBLE: 

I 385 

./ 

XD— RET-DESC 
JALR 



340 

HANDLER: RISCTOx86 



XD CONTAINS RETURN-DESCRIPTOR: 
INTERPRET XD: 

- REFORMAT/REPOSTION RESULT 
-LOADFPSW 

SP— [SP]//POPRA&ARGS i 



V 
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HANDLER: x86 TO RISC 



EPC<1 :0> == 00: 322 

LR— (SP] 

SP— SP + 4 

AP— SP 

SP— SP-8 

SP— SP & (-32) 

__XD_rdQ 

EPC<1:0> == 01: 



EPC<1:0> == 1x: 
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FLAT 32-BIT "NEAR" ADDRESS SPACE 




INITIATE X86EXCEP. OR INT. 



ALLOC FREE OR OLDEST SAVE SLOT 
STORE TIMESTAMP & FULL STATE 
x86 REGS —SAVE SLOT ID, TIMESTAMP 
EPC<1:0>— 01 
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HANDLER: x86 TO RISC 
EPC<1:0> == 00: 



EPC<1:0> == 01: 
x86 REGS POINTS TO SAVE SLOT 
USING TS VERIFY NO OVERWRITE 
RESTORE FULL STATE 
FREE SAVE SLOT 
EPC<1:0>— 00 370 
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EPC<1:0>== 1x: 



320 



FIG. 3N 



FLAT 32-BIT "NEAR" ADDRESS SPACE 




340 

HANDLER: RISCTOx86 



XD CONTAINS RETURN-DESCRIPTOR: 



VIXD CONTAINS CALL-DESCRIPTOR 71 1 ^ 
ESI— SP 

INTERPRET XD, REPOSITION ARGSf—f 

LR<1:0>— IxPERXD / 
PUSH LRAS RA(RETADDR) X 7 



r 



— HANDLER: x86 TO RISC 
EPC<1:0> ==00: 



EPC<1:0> == 01: 



EPC<1:0> == 1x: 
REFORMAT /REPOSITION THE 
FUNCTION RESULT PER EPC<0> 
SP— ESI 

EPC<1:0>— 00 329 
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PROBP EVENT BIT- 
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ITLB PROBE 
ATTRIBUTE 

An 

OR 
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CODE 
40? 


EVENT 


REUSE 
EVENT 










0.0000 


DEFAULT (x86 TRANSPARENT) EVENT, REUSE ALL CONVERTER VALUES 


YES 




NO 




REUSE EVENT CODE 




0.0001 


SIMPLE x86 INSTRUCTION COMPLETION (REUSE EVENT CODE) 


YES 




NO 




REUSE EVENT CODE 




0.0010 


PROBE EXCEPTION FAILED 


YES 




NO 




REUSE EVENT CODE 




0.0011 


PROBE EXCEPTION FAILED, RELOAD PROBE TIMER 


YES 




NO 




REUSE EVENT CODE 




0.0100 


FLUSH EVENT 


NO 


NO 


NO 


NO 






0.0101 


SEQUENTIAL; EXECUTION ENVIRONMENT CHANGED - FORCE EVENT 


NO 


YES 


NO 


NO 


• 




0.0110 


FAR RET 


NO 


YES 


YES 


NO 






0.0111 


IRET 


NO 


YES 


NO 


NO 


* 


V 


0.1000 


rin ah i 

FAR CALL 


NO 


YES 


YES 


YES 


FARCALL 




0.1001 


FARJMP 


NO 


YES 


YES 


NO 






A A f\ a n 

0.1010 


AAFAlll n ll li itar fy/fai itiaii ai tnm \f rv/mi uiArni iatiau n itiJI 

SPECIAL; EMULATOR EXECUTION, SUPPLY EXTRA INSTRUCTION DATA" 


NO 


YES 


NO 


NO 


• 




f\ A t\A A 

0.1011 


i PiAnT nn Am r aai i r atiaii 

ABORT PROFILE COLLECTION 


NO 


NO 


NO 


NO 


* 




0.1100 


A A A\ A 1 Al In A l IAI IAI I Al A f Al in At I Al i A it iTrftni mT n imn An^ fAnn m 

x86 SYNCHRONOUS/ ASYNCHRONOUS INTERRUPT W/PR0BE (GRP 0) 


NO 


YES 


YES 


YES 


EMULATOR PROBE 




n A A f\A 

0.1101 


A A A\AIAimAIIAtlAftAVniAlinAI1AIIA II ITTnni mr /Ann Al 

x86 SYNCHRONOUS/ASYNCHRONOUS INTERRUPT (GRP 0) 


NO 


YES 


YES 


NO 






0.1110 


x86 SYNCHRONOUS/ASYNCHRONOUS INTERRUPT W/PROBE (GRP 1) 


NO 


YES 


YES 


YES 


EMULATOR PROBE 




0.1111 


ftrt At A IAI in A 1 IAI AI/IIAI in At IAI IA 11 t^mni ir\w /Ann it 

x86 SYNCHRONOUS/ASYNCHRONOUS INTERRUPT (GRP 1) 


NO 


YES 


YES 


NO 


• 




1.0000 


IP-REIATIVE JNZ FORWARD (OPCODE: 75, OF 85) 


NO 


YES 


YES 
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